Connect a Teams tenant in Live Hub
When you connect a Microsoft tenant, Live Hub receives the administrative permissions required to manage the tenant's telephony services. Before you start, create an app registration in Azure, assign it the required roles (see Required roles for the app registration), and free an eligible license.
Required roles for the app registration
During initial onboarding and while creating Teams connections, the app registration must have the following roles:
- Domain Name Administrator
- User Administrator
- Application Administrator
- Teams Administrator
Once onboarding and the creation of all Teams connections are complete, you can remove Domain Name Administrator, User Administrator and Application Administrator. Only Teams Administrator must remain.
If you need to add another Teams connection later, assign Domain Name Administrator and User Administrator to the app registration again.
Connect the tenant
To connect Live Hub to your Teams tenant:
-
In the Navigation pane, expand Voice channels, and select Microsoft Teams.
-
Click Connect tenant.
-
Select the license type:
- Hosted Essential + license — you assign phone numbers to Teams users by
hand, one at a time in the portal or in bulk from a
.csvfile. - Hosted Pro license — you can additionally assign lifecycle management templates by Microsoft Entra ID security group, assign phone numbers automatically from predefined ranges, and carry out other tenant management tasks. See Lifecycle management.
- Hosted Essential + license — you assign phone numbers to Teams users by
hand, one at a time in the portal or in bulk from a
-
In the 'Number of users' field, enter how many Teams users may be assigned phone numbers. This determines the cost of Teams connectivity, and you can change it after the connection exists.
-
In the 'Email address' field, enter the address the activation email is sent to: your own, or your IT administrator's if they created the app registration.
-
Click Create.
The tenant moves to the connecting state and stays there until you finish activation.
-
Open the activation email and follow it, or click the tenant activation link in the portal.
-
On the Tenant Activation screen, click Use App Registration.
-
Enter the 'Microsoft Tenant ID', 'Application (Client ID)', and 'Client Secret' from Azure.
-
Click Start authentication.
-
Back in the Live Hub portal, select Microsoft Teams in the Navigation pane, and then wait for the connection to be established, which can take up to 5 minutes.
Once the connection is established, the screen refreshes to show your Teams tenant ID and admin domain, along with the Configure, Manage, and Reauthenticate buttons.
If the app registration's credentials change later, click Reauthenticate and run through the authentication again.
The tenant is now connected. Continue with Create a Teams connection.